Node / meshtastic / Meshtastic-Android / files / core / database / src / jvmMain / kotlin / org / meshtastic / core / database / DatabaseBuilder.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.database

Tff7b72import T7ee787androidx.datastore.core.DataStore

Tff7b72import T7ee787androidx.datastore.core.handlers.ReplaceFileCorruptionHandler

Tff7b72import T7ee787androidx.datastore.preferences.core.PreferenceDataStoreFactory

Tff7b72import T7ee787androidx.datastore.preferences.core.Preferences

Tff7b72import T7ee787androidx.datastore.preferences.core.emptyPreferences

Tff7b72import T7ee787androidx.room3.Room

Tff7b72import T7ee787androidx.room3.RoomDatabase

Tff7b72import T7ee787androidx.sqlite.driver.bundled.BundledSQLiteDriver

Tff7b72import T7ee787okio.FileSystem

Tff7b72import T7ee787okio.Path

Tff7b72import T7ee787okio.Path.Companion.toPath

Tff7b72import T7ee787org.meshtastic.core.database.MeshtasticDatabase.Companion.configureCommon

Tff7b72import T7ee787java.io.File

T8b949e/**

* Resolves the desktop data directory for persistent storage (DataStore files, Room database). Defaults to

* `~/.meshtastic/`. Override via `MESHTASTIC_DATA_DIR` environment variable.

*

* Shared between `core:database` and `desktop` module to ensure all persistent data is co-located.

*/

Tff7b72fun Td2a8ffdesktopDataDirTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{

Tff7b72val Te6edf3override Tff7b72= Te6edf3SystemTb4b4b4.Te6edf3getenvTb4b4b4(Ta5d6ff"Ta5d6ffMESHTASTIC_DATA_DIRTa5d6ff"Tb4b4b4)

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3overrideTb4b4b4.Te6edf3isNullOrBlankTb4b4b4(Tb4b4b4)Tb4b4b4) Tff7b72return Te6edf3override

Tff7b72return Te6edf3SystemTb4b4b4.Te6edf3getPropertyTb4b4b4(Ta5d6ff"Ta5d6ffuser.homeTa5d6ff"Tb4b4b4) Tff7b72+ Ta5d6ff"Ta5d6ff/.meshtasticTa5d6ff"

Tb4b4b4}

T8b949e/** Returns a [RoomDatabase.Builder] configured for JVM/Desktop with the given [dbName]. */

Tff7b72actual Tff7b72fun Td2a8ffgetDatabaseBuilderTb4b4b4(Te6edf3dbNameTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3RoomDatabaseTb4b4b4.Te6edf3BuilderTff7b72<Te6edf3MeshtasticDatabaseTff7b72> Tb4b4b4{

Tff7b72val Te6edf3dbFile Tff7b72= Te6edf3FileTb4b4b4(Te6edf3desktopDataDirTb4b4b4(Tb4b4b4)Tb4b4b4, Ta5d6ff"Tffd700$Te6edf3dbNameTa5d6ff.dbTa5d6ff"Tb4b4b4)

Te6edf3dbFileTb4b4b4.Te6edf3parentFileTff7b72?.Te6edf3mkdirsTb4b4b4(Tb4b4b4)

Tff7b72return Te6edf3RoomTb4b4b4.Te6edf3databaseBuilderTff7b72<Te6edf3MeshtasticDatabaseTff7b72>Tb4b4b4(

Te6edf3name Tff7b72= Te6edf3dbFileTb4b4b4.Te6edf3absolutePathTb4b4b4,

Te6edf3factory Tff7b72= Tb4b4b4{ Te6edf3MeshtasticDatabaseConstructorTb4b4b4.Te6edf3initializeTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Tb4b4b4.Te6edf3configureCommonTb4b4b4(Tb4b4b4)

Tb4b4b4.Te6edf3setDriverTb4b4b4(Te6edf3BundledSQLiteDriverTb4b4b4(Tb4b4b4)Tb4b4b4)

Tb4b4b4}

T8b949e/** Returns a [RoomDatabase.Builder] configured for an in-memory JVM database. */

Tff7b72actual Tff7b72fun Td2a8ffgetInMemoryDatabaseBuilderTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3RoomDatabaseTb4b4b4.Te6edf3BuilderTff7b72<Te6edf3MeshtasticDatabaseTff7b72> Tff7b72=

Te6edf3RoomTb4b4b4.Te6edf3inMemoryDatabaseBuilderTff7b72<Te6edf3MeshtasticDatabaseTff7b72>Tb4b4b4(Te6edf3factory Tff7b72= Tb4b4b4{ Te6edf3MeshtasticDatabaseConstructorTb4b4b4.Te6edf3initializeTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4)

Tb4b4b4.Te6edf3configureCommonTb4b4b4(Tb4b4b4)

Tb4b4b4.Te6edf3setDriverTb4b4b4(Te6edf3BundledSQLiteDriverTb4b4b4(Tb4b4b4)Tb4b4b4)

T8b949e/** Returns the JVM/Desktop directory where database files are stored. */

Tff7b72actual Tff7b72fun Td2a8ffgetDatabaseDirectoryTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3Path Tff7b72= Te6edf3desktopDataDirTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3toPathTb4b4b4(Tb4b4b4)

T8b949e/** Deletes the database and its Room-associated files on JVM. */

Tff7b72actual Tff7b72fun Td2a8ffdeleteDatabaseTb4b4b4(Te6edf3dbNameTb4b4b4: Tffa657StringTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3dir Tff7b72= Te6edf3desktopDataDirTb4b4b4(Tb4b4b4)

Te6edf3FileTb4b4b4(Te6edf3dirTb4b4b4, Ta5d6ff"Tffd700$Te6edf3dbNameTa5d6ff.dbTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3deleteTb4b4b4(Tb4b4b4)

Te6edf3FileTb4b4b4(Te6edf3dirTb4b4b4, Ta5d6ff"Tffd700$Te6edf3dbNameTa5d6ff.db-walTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3deleteTb4b4b4(Tb4b4b4)

Te6edf3FileTb4b4b4(Te6edf3dirTb4b4b4, Ta5d6ff"Tffd700$Te6edf3dbNameTa5d6ff.db-shmTa5d6ff"Tb4b4b4)Tb4b4b4.Te6edf3deleteTb4b4b4(Tb4b4b4)

Tb4b4b4}

T8b949e/** Returns the system FileSystem for JVM. */

Tff7b72actual Tff7b72fun Td2a8ffgetFileSystemTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3FileSystem Tff7b72= Te6edf3FileSystemTb4b4b4.Te6edf3SYSTEM

T8b949e/** Creates a JVM DataStore for database preferences in the data directory. */

Tff7b72actual Tff7b72fun Td2a8ffcreateDatabaseDataStoreTb4b4b4(Te6edf3nameTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3DataStoreTff7b72<Te6edf3PreferencesTff7b72> Tb4b4b4{

Tff7b72val Te6edf3dir Tff7b72= Te6edf3desktopDataDirTb4b4b4(Tb4b4b4) Tff7b72+ Ta5d6ff"Ta5d6ff/datastoreTa5d6ff"

Te6edf3FileTb4b4b4(Te6edf3dirTb4b4b4)Tb4b4b4.Te6edf3mkdirsTb4b4b4(Tb4b4b4)

Tff7b72return Te6edf3PreferenceDataStoreFactoryTb4b4b4.Te6edf3createTb4b4b4(

Te6edf3corruptionHandler Tff7b72= Te6edf3ReplaceFileCorruptionHandlerTb4b4b4(Te6edf3produceNewData Tff7b72= Tb4b4b4{ Te6edf3emptyPreferencesTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4)Tb4b4b4,

Te6edf3produceFile Tff7b72= Tb4b4b4{ Te6edf3FileTb4b4b4(Te6edf3dirTb4b4b4, Ta5d6ff"Tffd700$Te6edf3nameTa5d6ff.preferences_pbTa5d6ff"Tb4b4b4) Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Tb4b4b4}